Skip to main content

Conventions

  • Currency amounts are integer minor units (for example cents).
  • Item quantity uses fixed-point scale x1000 (1000 = 1.000).
  • itemAmount is the final line total after item-level discount (if present).
  • Discount percent fields (discountPrc) are decimal percent values (for example 12.34 means 12.34%).
  • UTF-8 is required.
  • documentID is generated by Cashbox and is usually unknown to integrator on the first request.
  • For first-send and recovery flows, prefer documentExtID as the primary external key.
  • Dates:
    • yyyy-MM-dd HH:mm:ss for document timestamps.
    • yyyy-MM-dd for report date range.